home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 March / CMCD0305.ISO / Software / Demo / Itcomm / auscomp-itcommander-win5.exe / {pf} / Firebird / doc / README_installation.txt < prev    next >
Encoding:
Text File  |  2004-02-20  |  5.6 KB  |  148 lines
  1. -----------------------------------------------------------
  2. Firebird 1.5 installation notes
  3. -----------------------------------------------------------
  4.  
  5. 1. GENERIC INFORMATION
  6.  
  7.   The distribution of the version 1.5 has a number of
  8.   changes as compared with 1.0.
  9.  
  10. 1.1. Some files were renamed, namely:
  11.  
  12.   ibserver.exe -> fbserver.exe (SS architecture)
  13.   ibguard.exe -> fbguard.exe
  14.   interbase.msg -> firebird.msg
  15.   interbase.log -> firebird.log
  16.   isc4.gdb -> security.fdb
  17.  
  18.   Regarding the last item, it should be mentioned that
  19.   now the recommended extension for database files is
  20.   ".fdb" to avoid possible conflicts with "system restore"
  21.   feature of Windows ME/XP operating systems.
  22.  
  23. 1.2. Changes in the client library
  24.  
  25.   Now the client library is named "fbclient.dll". To provide a
  26.   compatibility with existing applications, a gateway library
  27.   "gds32.dll" is included in the distribution kit. This library
  28.   doesn't have any code but just redirects all calls to
  29.   fbclient.dll. Hence for old applications you must to have both
  30.   fbclient.dll and gds32.dll in the program directory or OS system
  31.   directory. It's recommended to use native fbclient.dll library
  32.   in newly developed applications. All server utilities (gbak,
  33.   gfix, etc) uses only fbclient.dll and do not require gds32.dll.
  34.  
  35. 1.3. New configuration file
  36.  
  37.   ibconfig file is no longer used and it has been replaced with
  38.   firebird.conf, which is a part of new configuration manager and
  39.   allows you to use both old and some new options. You can see
  40.   the list of all supported configuration options (as well as
  41.   their default values) in the distributed version of this file.
  42.   
  43.  
  44. 1.4. Classic Server (CS)
  45.  
  46.   Since Firebird 1.5, Classic engine is included in win32
  47.   distributions. The file of this server version is named
  48.   fb_inet_server.exe and support TCP/IP and NetBEUI network
  49.   protocols (local protocol is not supported). The usage of
  50.   the Classic engine doesn't differ from its SS variant,
  51.   except of the architecture specifics (one server process
  52.   is running per client connection).
  53.  
  54. 1.5. Ability to install and work with existent IB/FB1 server
  55.  
  56.   There were some changes done in the system object names
  57.   to allow FB 1.5 to be installed and used on the computer
  58.   which already has IB/FB1 installed. FB 1.5 also uses
  59.   another registry keys. If you setup the server to use
  60.   different network ports, you also can run a few server
  61.   instances simultaneously or run FB 1.5 in the same time
  62.   with IB/FB1.
  63.  
  64. 1.6. Compatibility with previous versions
  65.  
  66.   Name of the local IPC port is no longer compatible, i.e.
  67.   with default server settings you cannot connect to it from
  68.   applications using old client library (gds32.dll). If
  69.   necessary, you can setup the server to use old name of the
  70.   IPC map via the configuration file.
  71.  
  72.   New version uses updated ODS (10.1). It doens't cause any
  73.   incompatibilities with previous versions, but you should be
  74.   aware of this fact. Engine doesn't upgrade ODS automatically
  75.   and Firebird 1.0 and 1.5 can use both ODS 10.0 and 10.1 databases.
  76.   Regardless of the above, backup/restore is still the
  77.   recommended procedure of migrating databases to the different
  78.   version of the server.
  79.  
  80.   Since a number of bugs has been fixed, the behaviour of the
  81.   database may change after downgrading from v1.5 to v1.0.
  82.   The datailed information of all such issues (as well as
  83.   appropriate recommendations) will be published separately.
  84.  
  85.   Some specifics of the server work have been changed in v1.5.
  86.   For more detailed information see configuration file
  87.   (firebird.conf) and release notes (WhatsNew.txt).
  88.  
  89. 2. INSTALLATION
  90.  
  91.   The installation of FB 1.5 doesn't practically differ from
  92.   previous versions.
  93.  
  94. 2.1. Required steps
  95.  
  96.   If you don't have a special setup program (it's distributed
  97.   separately) the steps are the following:
  98.  
  99.   - unzip the archive into the separate directory (since a few 
  100.     file names were changed, it doesn't make sense to unzip
  101.     v1.5 files into the directory with IB/FB1)
  102.   - change the current directory to <root>\bin (here and below 
  103.     <root> is the directory where v1.5 files are located)
  104.   - run instreg.exe:
  105.       instreg.exe install
  106.     it causes the installation path to be written into the registry
  107.     (HKLM\Software\Firebird Project\Firebird Server\Instances)
  108.   - if you want to register a service, run also instsvc.exe:
  109.       instsvc.exe install
  110.   - optionally, you should copy both fbclient.dll and gds32.dll
  111.     to the OS system directory
  112.  
  113. 2.2. Installation of CS
  114.  
  115.   To install the CS engine, the only difference is the additional
  116.   option for instsvc.exe:
  117.       instsvc.exe install -classic
  118.  
  119.   It means that you may have only one copy of the engine (either
  120.   fbserver.exe or fb_inet_server.exe) to be installed as a service.
  121.  
  122. 2.3. Simplified setup
  123.  
  124.   If you don't need a registered service, then you may avoid running
  125.   both instreg.exe and instsvc.exe. In this case you should just unzip
  126.   the archive into a separate directory and run the server:
  127.     fbserver.exe -a
  128.   It should treat its parent directory as a root directory in this
  129.   case.
  130.  
  131. 2.4. Uninstallation
  132.  
  133.   To remove FB 1.5 you should:
  134.  
  135.   - stop the server
  136.   - run "instsvc.exe remove"
  137.   - run "instreg.exe remove"
  138.   - delete installation directory
  139.   - delete fbclient.dll and gds32.dll from the OS system directory
  140.  
  141. 3. INFORMATION ABOUT THIS VERSION
  142.  
  143.   All changes included in FB 1.5 are briefly described in file:
  144.     <root>\doc\WhatsNew.txt
  145.   Full documentation about new features and bugfixes will be
  146.   published in the official Release Notes, which will be available
  147.   in the final release.
  148.